MakeCode图形化库API汇总

A. SuperBit V2

1)

功能：设置扩展板上的蜂鸣器播放一种音乐

2)

功能：设置舵机转到某一角度

参数： 编号：对应的舵机接口S1-S8 角度：根据舵机角度范围分别设置0-180，0-270

例如：

3)

功能：设置舵机以某一速度向某一方向转动

参数： 编号：对应的舵机接口S1-S8 速度：0-90 方向：正转、反转、停止

例如：

4)

功能：设置单个电机以某一速度转动

参数： 编号：对应的电机接口M1-M4 速度：设置电机转动速度-255~255，负值表示反转

例如：

5)

功能：同时设置两个电机分别以某一速度转动

参数： 编号：对应的电机接口M1-M4 速度：设置电机转动速度-255~255，负值表示反转

例如：

6)

功能：让所有电机停止运动

B. SuperBit V2 数字类

1)

功能：DHT11传感器检测到的温湿度数值

参数： 值：检测到的摄氏温度（℃）、华氏温度（℉）、湿度（0~100） 引脚：传感器连接到扩展板上的对应引脚

例如：

2)

功能：超声波检测到的距离

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

3)

功能：设置人体红外传感器返回的某一状态作为判断条件

参数： 引脚：传感器连接到扩展板上的对应引脚 状态：传感器返回的 有人移动 和 没人移动 两种状态

例如：

4)

功能：设置红外传感器返回的某一状态作为判断条件

参数： 引脚：传感器连接到扩展板上的对应引脚 状态：传感器返回的 有障碍 和 无障碍 两种状态

例如：

5)

功能：设置按键的某一状态作为判断条件

参数： 引脚：按键连接到扩展板上的对应引脚 状态：按键被 按下 和 松开 的两种状态

例如：

6)

功能：设置碰撞检测传感器的某一状态作为判断条件

参数： 引脚：传感器连接到扩展板上的对应引脚 状态：传感器返回的 未碰撞 和 碰撞 的两种状态

例如：

7)

功能：设置震动传感器为某一状态

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

C. SuperBit V2 观感类

1)

功能：光敏传感器检测的数值，亮度越低，返回的数值越大

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

2)

功能：声音传感器输出的模拟值，范围为 0~1023，声音越大输出的模拟值就越大

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

3)

功能：电位器当前的阻值

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

4)

功能：设置摇杆的某一状态作为判断条件

参数： 引脚：摇杆连接到扩展板上的对应引脚 状态：摇杆的 无、上 、下、左、右 的5种状态

例如：

D. SuperBit V2 PWM类

1)

功能：设置蜂鸣器连接到某引脚

参数： 引脚：传感器连接到扩展板上的对应引脚

例如：

2)

功能：设置震动马达以某一速度震动

参数： 引脚：传感器连接到扩展板上的对应引脚 速度：振动速度，范围0-1023

例如：

3)

功能：分别设置RGB灯的R、G、B值改变颜色

参数： 引脚：传感器连接到扩展板上的对应引脚 红、绿、蓝：灯的RGB值，范围0-255

例如：

4)

功能：设置RGB灯的颜色

参数： 引脚：传感器连接到扩展板上的对应引脚 颜色显示：灭 和 几种固定的颜色

例如：

E. Neopixel

1)

功能：创建并初始化一条灯带

参数： 引脚：灯带连接的引脚 颗数：等待上的灯珠数量 模式：灯珠采用的模式，有RGB（GRB顺序）、RGB + W、RGB（RGB顺序）

例如：

2)

功能：从彩灯条中选取一段范围，从某个灯开始，选取一定数量的灯。

参数： 像素：灯的起始位置 长度：即选取的灯的个数

例如：

3)

功能：让灯带呈现某个色相范围的渐变色效果

参数： 色相：范围0-360（完整的色环）

例如：

4)

功能：让灯带呈现某个颜色

参数： 颜色：几个固定的颜色，如红、橙、黄、紫罗兰等等

例如：

5)

功能：以柱状图方式显示数值在 LED 灯带上。

参数： 值：当前显示的值 最大值：值可以设置的最大数，当设置为这个最大值时，则灯珠全部点亮

例如：

6)

功能：刷新灯带的显示

7)

功能：清除灯带的显示，也就是关灯

8)

功能：将色相、饱和度、亮度值转换为RGB 颜色

参数： 色相：范围 0-360 饱和度：范围0-99 亮度：范围0-99

例如：

9)

功能：控制灯带以某一像素移动。将灯带的像素整体向前（forward）移动指定数量的像素，并用“0”（即关闭的像素）来清除尾部留下的位置

前提：使用后，还需要调用 刷新显示 才能将变化显示出来

参数： 偏移量：灯带移动的像素

例如：

10)

功能：控制灯带以某一像素循环移动，即将前面的像素移到后面

前提：使用后，还需要调用 刷新显示 才能将变化显示出来

参数： 偏移量：灯带移动的像素

例如：

11)

功能：设置某个像素位置的白灯亮度

前提：仅适用于 RGBW 灯珠（不是普通的 RGB 灯珠）.使用后，还需要调用 刷新显示 才能将变化显示出来

参数： 像素：要设置的第几个灯珠（从 0 开始计数） 亮度：范围0-255

例如：

12)

功能：设置灯带上某个像素位置的灯珠显示某种颜色

前提：使用后，还需要调用 刷新显示 才能将变化显示出来

参数： 像素：要设置的第几个灯珠（从 0 开始计数） 颜色：灯条要显示的颜色

例如：

13)

功能：获取灯带上的灯珠数量

14)

功能：设置灯条亮度

参数： 亮度：范围0-255，数值越大越亮

15)

功能：减小灯条的亮度

16)

功能：估算当前灯光配置消耗的电流

17)

功能：设置灯带每行的灯珠数量、整个矩阵的朝向、排布方式

前提：是矩阵形状的灯带或灯板

参数：

width：每行灯珠数量 rotation：旋转方式 0-NeoRotation.Rotate0（不旋转）、1-NeoRotation.Rotate90（顺时针90度）、2-NeoRotation.Rotate180（上下颠倒）、3-NeoRotation.Rotate270（顺时针270度） chain：排布方式 0-NeoMatrixChain.None（正常排布）、1-NeoMatrixChain.ZZ（Z 字排布）

18)

功能：设置矩阵形状的灯带上的具体坐标位置的灯珠颜色

前提：是矩阵形状的灯带或灯板

参数： x、y：横纵坐标 颜色：灯珠显示的颜色